home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1997 November / Macworld (1997-11).dmg / Shareware World / Utilities / Compression / ZipIt 1.3.8 / ZipIt docs / ZipIt docs.rsrc / TEXT_133.txt < prev    next >
Text File  |  1997-09-01  |  3KB  |  40 lines

  1. Scripting ZipIt
  2.  
  3. Starting with version 1.3.7, ZipIt is fully scriptable. This means that you can do anything via AppleScript that you can manually. The scripting capability is very powerful; this section is meant to provide a taste of a few things that can be done with it. If you need more detailed help, you can always send me email.
  4.  
  5. There are a number of different types of objects that ZipIt defines to make scripting easier:
  6.  
  7. ‚Ä¢ a window is synonymous with a document, and refers to an open zip archive
  8. ‚Ä¢ an entry refers to a file or folder within a zip archive
  9. ‚Ä¢ a file refers to a file within a zip archive
  10. ‚Ä¢ a folder refers to a folder within a zip archive
  11.  
  12. Entries, files, and folders are numbered separately, so if you have an archive that consists of a file and then a folder, folder 1 will refer to the folder, file 1 will refer to the file, and entry 1 will refer to the file, and entry 2 will refer to the folder. Also, entries, files, and folders are numbered relative to the current window unless you specify otherwise. File 1, in other words, refers to the first file in the window, not the first file in the archive. To see the significance of this, suppose you open an archive with a folder in it. You then open the folder. File 1 now refers to the first file in the folder that you just opened - in other words, it changed, now that you‚Äôve opened a folder. Absolute references are possible by the use of the ‚Äúroot‚Äù property of a window or document. To refer to the first file in the archive, you can refer to ‚Äúfile 1 of root of window 1‚Äù. The root is the topmost level of the archive. Whenever ZipIt returns an object reference, it always refers to it from the root to avoid confusion.
  13.  
  14. Each object has elements and properties, which are listed fully in ZipIt‚Äôs dictionary (choose Open Dictionary in Script Editor to see ZipIt‚Äôs AppleScript dictionary). Windows and documents contain entries, files, and folders as elements, so you can refer to a file by saying ‚Äúfile 1 of window 1‚Äù. You can also use names, e.g., ‚Äúfile "test" of window "archive.zip"‚Äù.
  15.  
  16. To zip files:
  17.  
  18. tell application "ZipIt"
  19.     activate
  20.     set file_to_zip to (choose file)
  21.     set zip_archive to (make new window at the beginning)
  22.     add file_to_zip to zip_archive
  23.     compress zip_archive to file "Hard disk:Desktop folder:archive.zip"
  24. end tell
  25.  
  26. The variable file_to_zip, above, can also be a list of files or folders.
  27.  
  28. To unzip an archive:
  29.  
  30. tell application "ZipIt"
  31.     activate
  32.     set archive_to_unzip to (choose file)
  33.     open archive_to_unzip
  34.     extract every entry in window 1 into file "Hard disk:desktop folder:" -- Note the use  of the 'file' keyword here
  35. end tell
  36.  
  37. To create a new folder, say ‚Äúmake new folder at end of window 1 with properties {name:"foldername"}‚Äù. As an alternative to the ‚Äúadd‚Äù command, if you want more control (but less intuitiveness), you can write ‚Äúmake new file at end of window 1 with properites {disk file: file "whatever"}‚Äù. You can naturally also specify other properties in the make command.
  38.  
  39. If you have further questions about scripting, the ZipIt homepage may have an answer to your question (see the introductory section for the URL). Otherwise, feel free to send me email.
  40.